枚举摄像头 - EnumCameras

函数简介

枚举本机摄像头，以及驱动报告的像素规格。不占用设备，适合在 OpenCameraEx 或 display="camera" 绑定之前选择设备和分辨率。

formats[].width / formats[].height 就是该设备支持的像素大小。

接口名称

EnumCameras

DLL调用

int64_t EnumCameras(int64_t instance);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。

返回 JSON

成功时为 JSON 数组。每项字段：

字段	类型	说明
index	整数	设备索引，对应 OpenCamera 的 deviceIndex，以及 SetConfig 的 CameraIndex。
name	字符串	设备友好名。按名称打开或绑定时写入 OpenCameraEx / CameraName。
path	字符串	设备路径；部分后端可能为空。
backend	字符串	枚举后端，如 DSHOW、MSMF、DEFAULT。
formats	数组	驱动报告的可选规格。每项含 width、height、fps、fourcc。

[
  {
    "index": 0,
    "name": "USB Camera",
    "path": "",
    "backend": "DSHOW",
    "formats": [
      { "width": 1920, "height": 1080, "fps": 30.0, "fourcc": "MJPG" },
      { "width": 1280, "height": 720, "fps": 30.0, "fourcc": "YUY2" }
    ]
  }
]

Windows 下优先走 DirectShow 枚举。DirectShow 枚举为空时，会按索引探测前若干个设备，此时 formats 可能只有当前默认规格一项。

示例

SDK 调用

#include "OLAPlugServer.h"

OLAPlugServer ola;
std::string cameras = ola.EnumCameras();

using OLAPlug;

var ola = new OLAPlugServer();
string cameras = ola.EnumCameras();

from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
cameras = ola.EnumCameras()

import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
String cameras = ola.EnumCameras();

import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
cameras := ola.EnumCameras()

use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let cameras = ola.enum_cameras();

var ola = com("OlaPlug.OlaSoft")
var cameras = ola.EnumCameras()

Set ola = CreateObject("OlaPlug.OlaSoft")
cameras = ola.EnumCameras()

.局部变量 ola, OLAPlug
ola.创建 ()
cameras ＝ ola.EnumCameras()

import OLAPlugServer;
var ola = OLAPlugServer();
var cameras = ola.EnumCameras();

变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
文本型 cameras = ola.EnumCameras()

#include "OLAPlugServer.h"

OLAPlugServer ola;
std::string cameras = ola.EnumCameras();

原生 DLL 调用

int64_t ptr = EnumCameras(instance);
// 读取 JSON 后调用 FreeStringPtr(ptr)

using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long EnumCameras(long ola);

long ptr = EnumCameras(instance);

from ctypes import CDLL, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
ola.EnumCameras.restype = c_int64
ptr = ola.EnumCameras(instance)

返回值

返回值	说明
（返回值）	字符串指针，内容为摄像头 JSON 数组。失败返回 0。返回的字符串指针需要调用 FreeStringPtr 释放内存。

注意事项

项目	说明
绑定前读取	本接口不打开设备。绑定后的实际像素大小用 GetBindCameraInfo 或 GetClientSize。
规格是驱动报告值	formats 是驱动声明的可选规格，设备最终协商结果可能不同。
无设备	本机没有摄像头时返回 JSON 数组 []（指针非 0）。接口失败才返回 0。